Skip to content

Add AI tool tips to key docs pages#5582

Merged
ethanpalm merged 2 commits intomainfrom
mintlify/ai-tool-tips-1777415905
Apr 29, 2026
Merged

Add AI tool tips to key docs pages#5582
ethanpalm merged 2 commits intomainfrom
mintlify/ai-tool-tips-1777415905

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 28, 2026

Summary

Addresses DOC-366 by adding tips on Mintlify AI tools, the Visibility component, and the Prompt component to high-traffic pages where users are most likely to benefit.

Changes

  • agent/index.mdx: Added a "Use AI tools alongside the agent" section with a Prompt component to install the Mintlify skill and MCP server.
  • cli/index.mdx: Added a tip and Prompt component recommending users install the skill and MCP server while working locally.
  • ai-native.mdx: Added a tip showing users how to embed a skill.md install prompt for their own product using the Prompt component.
  • assistant/index.mdx: Added a tip in "Make content AI ingestible" recommending the Visibility component to tailor content for humans and AI tools.
  • ai/contextual-menu.mdx: Added a tip cross-linking the contextual menu with skill.md and the MCP server so users install full product capabilities.

Note

Low Risk
Documentation-only changes that add tips and example prompts; risk is limited to potential broken links or MDX component rendering issues.

Overview
Adds AI tool guidance to key docs pages, including new tips and Prompt callouts that encourage installing the hosted skill.md and connecting the MCP server (notably on agent/index.mdx and cli/index.mdx).

Also adds small cross-linking tips in ai-native.mdx and ai/contextual-menu.mdx, plus a Visibility usage tip in assistant/index.mdx to help tailor content for humans vs AI tools.

Reviewed by Cursor Bugbot for commit 1eb57b5. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented Apr 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟢 Ready View Preview Apr 28, 2026, 10:44 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 28, 2026, 10:47 PM

Comment thread agent/index.mdx Outdated
@ethanpalm ethanpalm merged commit b9cfd78 into main Apr 29, 2026
6 checks passed
@ethanpalm ethanpalm deleted the mintlify/ai-tool-tips-1777415905 branch April 29, 2026 00:10
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 1eb57b5. Configure here.

Comment thread agent/index.mdx
npx skills add https://mintlify.com/docs

Then add the Mintlify MCP server for access to documentation search. Follow the setup instructions at https://www.mintlify.com/docs/ai/model-context-protocol.md
</Prompt>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Identical Prompt block duplicated across two files

Low Severity

The Prompt block (description, actions, and all children content) is copy-pasted verbatim between agent/index.mdx and cli/index.mdx. A near-identical block also exists in quickstart.mdx. The project already has a snippets/ directory used for shared content (e.g., icons-required.mdx). Extracting this into a reusable snippet would prevent the copies from drifting out of sync during future updates.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 1eb57b5. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants